home *** CD-ROM | disk | FTP | other *** search
/ LOGIC Apps / Logic-APPLE_II_APPS.iso / mac / LOGIC Apple II 5.25" Library - ProDOS / PRO041.dsk / ZBASIC.DEMO.DOC.txt < prev    next >
Text File  |  2012-02-16  |  9KB  |  210 lines
  1.                 ZBasic Version 4.0 Demonstration Documentation
  2.                           A product of Zedcor, Inc.
  3.  
  4.  
  5. Welcome to the most powerful BASIC available for the Apple //'s.  If you're
  6. tired of the limitations that Applesoft (and all of the various Applesoft
  7. compilers) put on you, you have a pleasant surprise in store for you.
  8.  
  9. This demonstration version has everything that the standard version has, with
  10. the following limitations built in:
  11.  
  12.         The edit buffer is limited to 4K of source code space.
  13.         The system does not automatically use a /RAM disk, if installed.
  14.         You will not be able to compile a program to disk.
  15.         You will not be able to save your configuration.
  16.  
  17. In addition, this is the 64K ProDOS version.  The complete ZBasic package
  18. includes a 64K version that will run on any 64K Apple, and a 128K version,
  19. which requires 128K for both program development and execution.  Of course,
  20. there are trade-offs between either version.  The 64K version only has about
  21. 18K of work space, but it will allow you to write programs that will run on
  22. the older Apple ]['s.  The 128K version has a lot more room available (26K
  23. program, 28K variables and file buffers), but requires at least 128K of memory
  24. and a 65C02 (or equivalent) processor.
  25.  
  26. You will need at least one disk drive to use ZBasic (but who doesn't have a
  27. disk drive these days!).  ZBasic also supports (but does not require) a
  28. printer and interface, serial interfaces, 80-column cards, a mouse
  29. w/interface, a joystick, or any other peripheral you have attached.
  30.  
  31.  
  32. Instructions for Use
  33. --------------------
  34.  
  35. First of all, you must have ProDOS booted prior to entering ZBasic.  From the
  36. Applesoft prompt enter:
  37.  
  38.         PREFIX <whatever directory the ZBASIC.SYSTEM file resides in>
  39.         -ZBASIC.SYSTEM
  40.  
  41. You will soon see the ZBasic title page.  Check out the artwork (!), then
  42. press any key to continue on into the system.  You will come to the
  43. configuration menu eventually.  At this point, you can either press "E" to
  44. enter the line editor, or "C" to configure the system to your liking.
  45.  
  46.  
  47. Configuration
  48. This is where you can set up ZBasic to your own preferences.  You can set the
  49. size of floating point variables (both single and double precision), maximum
  50. file buffers open (you are limited to 1 in this demo version), array base
  51. (either 0 or 1), default variable type, and some other stuff.  If you get to
  52. an option that you don't wish to change, simply press the RETURN key to accept
  53. the current value.  Once the configuration options have all been presented,
  54. you will be given the option of configuring again, or entering the editor.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. A Typical ZBasic Session
  68. We'll walk you through a typical ZBasic session to show you how to TYPE, RUN,
  69. SAVE, QUIT, and LOAD your programs.  First of all, get into the editor by
  70. typing "E" from the configure menu.  Then type in this program exactly as
  71. shown.  Remember to press RETURN at the end of each line:
  72.  
  73.         10 FOR COUNT = 1 TO 10
  74.         20 PRINT "HI THERE, I'M ZBASIC!---"
  75.         30 NEXT COUNT
  76.  
  77. Congratulations, you've just entered your first ZBasic program.  To see the
  78. program type:
  79.  
  80.         LIST
  81.         or
  82.         L
  83.  
  84. and press RETURN.  To run the program, type:
  85.  
  86.         RUN
  87.  
  88. and press RETURN (just like an interpreter).  The program will print "HI
  89. THERE, I'M ZBASIC!---" on the screen ten times.  To save your program, type:
  90.  
  91.         SAVE MYPROG
  92.  
  93. Your program will be saved to disk for any possible future use.  To make sure
  94. it got there, type:
  95.  
  96.         DIR
  97.  
  98. A directory of your disk will appear, with MYPROG somewhere in the list.  The
  99. file type will be ZBS, which stands for a ZBasic tokenized program.  You also
  100. have the option of saving in pure ASCII format, but more on that later.  To
  101. get out of ZBasic, type:
  102.  
  103.         QUIT
  104.  
  105. You will then be prompted for the next ProDOS ".SYSTEM" program to run.  To
  106. load a previously saved program, get back into ZBasic, then type:
  107.  
  108.         LOAD MYPROG
  109.  
  110. Your program will be reloaded, ready for whatever you wish to do with it.  One
  111. other command that will be VERY useful while using this demonstration is the
  112. HELP command.  Typing HELP while in the editor will give you an index of the
  113. main help topics available.  Press the space bar to scroll through the topics.
  114. I say this is going to be useful because this is basically where all of the
  115. documentation is going to be for you.  The regular ZBasic manual is about 700
  116. pages long, and I'm NOT going to type all that into this file!  The help file
  117. contains information on all of the features of ZBasic, although the
  118. information is somewhat terse.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. Full Screen Editor
  134. You also have a full screen text editor available for editing your programs.
  135. To get into it type
  136.  
  137.         EDITOR
  138.  
  139. while in the line editor.  The program currently in memory will be transformed
  140. into an ASCII file, and then loaded into the full screen editor.  The commands
  141. available are summarized in the following chart.
  142.  
  143. ------------------------------------------------------------------------------
  144. | 40-column editor      | Cursor Movement       | 80-column editor           |
  145. ------------------------------------------------------------------------------
  146. |    CTRL-S             | Left 1 character      | Left arrow                 |
  147. |    CTRL-D             | Right 1 character     | Right arrow                |
  148. |    CTRL-A             | Left 1 word           | Open-Apple-Left arrow      |
  149. |    CTRL-F             | Right 1 word          | Open-Apple-Right arrow     |
  150. | CTRL-Q CTRL-S         | To beginning of line  | Solid-Apple-Left arrow     |
  151. | CTRL-Q CTRL-D         | To end of line        | Solid-Apple-Right arrow    |
  152. |    CTRL-E             | Up 1 line             | Up arrow                   |
  153. |    CTRL-X             | Down 1 line           | Down arrow                 |
  154. |    CTRL-R             | Up 1 page             | Open-Apple-Up arrow        |
  155. |    CTRL-C             | Down 1 page           | Open-Apple-Down arrow      |
  156. | CTRL-Q CTRL-R         | To beginning of file  | Solid-Apple-Up arrow       |
  157. | CTRL-Q CTRL-C         | To end of file        | Solid-Apple-Down arrow     |
  158. ------------------------------------------------------------------------------
  159. |                       |    Commands           |                            |
  160. ------------------------------------------------------------------------------
  161. | CTRL-K CTRL-Q         | Return to Line Editor | ESC                        |
  162. | Left Arrow            | Delete character      | Delete                     |
  163. | CTRL-Q Left Arrow     | Delete to beginning   | Open-Apple-Delete          |
  164. |                       |   of line             |                            |
  165. | CTRL-Q CTRL-Y         | Delete to end of line | Solid-Apple-Delete         |
  166. | CTRL-V                | Switch Insert/Overwrite | Open-Apple-0             |
  167. | CTRL-K CTRL-N         | Clear text buffer       | Solid-Apple-0            |
  168. | CTRL-K CTRL-L         | Load File               | Open-Apple-1             |
  169. | CTRL-K CTRL-S         | Save File               | Solid-Apple-1            |
  170. | CTRL-K CTRL-X         | Cut Line                | Open-Apple-2             |
  171. | CTRL-K CTRL-V         | Paste Line              | Solid-Apple-2            |
  172. | CTRL-K CTRL-C         | Copy Line               | Open-Apple-3             |
  173. | CTRL-K CTRL-R         | Replace Line            | Solid-Apple-3            |
  174. | CTRL-N                | New Line                | Open-Apple-4             |
  175. | CTRL-Y                | Delete Line             | Solid-Apple-4            |
  176. | CTRL-Q CTRL-F         | Find                    | Open-Apple-5             |
  177. | CTRL-L                | Find next occurrence    | Solid-Apple-5            |
  178. | CTRL-K CTRL-I         | Set TAB Value           | Open-Apple-6             |
  179. | CTRL-Q CTRL-I         | Autotab on/off          | Solid-Apple-6            |
  180. | CTRL-K CTRL-F         | Restore Line            | Open-Apple-7             |
  181. | CTRL-K CTRL-P         | Print Text              | Solid-Apple-7            |
  182. | CTRL-Z                | Scroll Up               | Open-Apple-8             |
  183. | CTRL-W                | Scroll Down             | Solid-Apple-8            |
  184. | CTRL-K CTRL-T         | Freeze Top              | Open-Apple-9             |
  185. | CTRL-K CTRL-B         | Freeze Bottom           | Solid-Apple-9            |
  186. ------------------------------------------------------------------------------
  187.  
  188. The descriptions seem to be a little terse right now, but just play with them
  189. a little and get a feel for what they do.  Full descriptions are provided in
  190. the ZBasic user's manual.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. That's about it for this documentation.  Everything that you should need to
  200. get a feel for ZBasic can be found with the HELP command.  If you decide that
  201. you want a full working copy, then type "RUN ORDER.BLANK" while in the editor.
  202. This program will print an order form on your printer that you can use to
  203. order ZBasic.  If you don't have a printer yet, then call 1-800-452-4567 toll
  204. free.  Have your credit card ready.  The price is $49.95.
  205.  
  206. If you have any questions, you can call us directly, or leave mail on GEnie,
  207. address [ZBASIC].
  208.  
  209. Enjoy!
  210.